'\" t
.\"     Title: coap-rd
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 12/27/2024
.\"    Manual: coap-rd Manual
.\"    Source: coap-rd 4.2.0
.\"  Language: English
.\"
.TH "COAP\-RD" "5" "12/27/2024" "coap\-rd 4\&.2\&.0" "coap\-rd Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
coap-rd \- A CoAP Resource Directory based on libcoap
.SH "SYNOPSIS"
.sp
\fBcoap\-rd\fR [\fB\-A\fR addr] [\fB\-g\fR group] [\fB\-p\fR port] [\fB\-v\fR num]
.SH "DESCRIPTION"
.sp
\fBcoap\-rd\fR is a simple CoAP Resource Directory server that can handle resource registrations using the protocol CoAP (RFC 7252)\&.
.SH "OPTIONS"
.PP
\fB\-A\fR addr
.RS 4
The local address of the interface which the server has to listen\&.
.RE
.PP
\fB\-g\fR group
.RS 4
Join specified multicast
\fIgroup\fR
on startup\&.
.RE
.PP
\fB\-p\fR port
.RS 4
The
\fIport\fR
on the given address the server will be waitung for connections\&. The default port is 5683 if not given any other value\&.
.RE
.PP
\fB\-v\fR num
.RS 4
The verbosity level to use (default: 3, maximum is 9)\&. Above 7, there is increased verbosity in GnuTLS logging\&.
.RE
.SH "EXAMPLES"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Example
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
coap\-rd \-A ::1
.fi
.if n \{\
.RE
.\}
.sp
Let the server listen on localhost (port 5683)\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Example
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
coap\-rd \-A ::1 \-p 13011
.fi
.if n \{\
.RE
.\}
.sp
Quite the same, except listening port is \fI13011\fR (and not the default port 5683)\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Example
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
coap\-rd \-A 2001:db8:81a8:0:6ef0:dead:feed:beef  \-v 5
.fi
.if n \{\
.RE
.\}
.sp
The listening address is set to \fI2001:db8:81a8:0:6ef0:dead:feed:beef\fR and the verbosity level is set to \fI5\fR\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Example
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
coap\-rd \-A 2001:db8:81a8:0:6ef0:dead:feed:beef  \-g FF02:FD
.fi
.if n \{\
.RE
.\}
.sp
Set listening address to \fI2001:db8:81a8:0:6ef0:dead:feed:beef\fR and join the All CoAP Nodes multicast group \fIFF02:FD\fR\&.
.SH "FILES"
.sp
There are no configuration files\&.
.SH "EXIT STATUS"
.PP
\fB0\fR
.RS 4
Success
.RE
.PP
\fB1\fR
.RS 4
Failure (syntax or usage error; configuration error; document processing failure; unexpected error)
.RE
.SH "BUGS"
.sp
Please report bugs on the mailing list for libcoap: libcoap\-developers@lists\&.sourceforge\&.net
.SH "AUTHORS"
.sp
The libcoap project <libcoap\-developers@lists\&.sourceforge\&.net>
